home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / tarfnt21.zip / TarFront.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-07-04  |  46KB  |  676 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Overview ΓòÉΓòÉΓòÉ
  3.  
  4.  TarFront simplifies the process of backing up several files and directories in 
  5. several root directories and tar volumes and restoring files from existing 
  6. backups. It is a frontend for "tar" and "tape" which must be installed 
  7. separately according to their documentation (look for gtar*.zip and gtak*.zip). 
  8. A little understanding of "tar" and "tape" on the side of the user would be 
  9. helpful, even if not necessarily needed. 
  10.  
  11. Currently, TarFront does not compare or verify files from archives. This is 
  12. planned for a later version. 
  13.  
  14. This release of TarFront is public domain. You're free to do anything with it, 
  15. as long as no files are modified or left out of the archive. The author does 
  16. not guarantee that anything will work as documented here (most things should, 
  17. though <g>). You have been warned. For comments write to 
  18. ekraemer@pluto.camelot.de. 
  19.  
  20. Later versions (3.x) will become shareware with moderate pricing in the range 
  21. of 40-50 US$; versions 2.x (bug fixes, minor improvements) will always remain 
  22. free, though. 
  23.  
  24. See also: 
  25.  
  26.      Installation 
  27.      Startup 
  28.      Usage 
  29.      Examples 
  30.      Common Problems 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  34.  
  35. To install TarFront, unpack the TarFront archive and either use install.cmd, or 
  36. copy all files into a directory of your choice. If using install.cmd, you have 
  37. to specify a target directory, which must be different from the temporary 
  38. directory you unpacked the archive into. Also, the language has to be 
  39. specified. 
  40.  
  41.  install c:\tarfront20 e 
  42.            Copies all files to c:\tarfront20\ and installs the english version 
  43.            of the program. 
  44.  
  45.  install c:\tarfront20 d 
  46.            Copies all files to c:\tarfront20\ and installs the german version 
  47.            of the program. All program/dialog texts are german; there's no 
  48.            german online help, though. 
  49.  
  50.  install.cmd will create a folder on your desktop; this folder contains a link 
  51.  to the executable and documentation and a template for INI files. You can 
  52.  start TarFront by double-clicking copies of this template. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 3. Startup ΓòÉΓòÉΓòÉ
  56.  
  57. TarFront needs one startup parameter, which is a INI file name. This INI file 
  58. will take up all options of the current session. It is suggested that there's 
  59. one INI file for every tape (in the case of permanent data backups) or one INI 
  60. file for every type of regular backup (i.e., monthly, weekly, daily, with 
  61. different settings for the "generations", and so on). Tape directory files, 
  62. which contain the directories of the archives, should be named like their INI 
  63. files plus an additional extension to permit easy retrival of files. 
  64.  
  65. If you used "install" to install TarFront, you can simply drag *.TFN files onto 
  66. the executable or double-click on *.TFN files to start TarFront. 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 4. Usage ΓòÉΓòÉΓòÉ
  70.  
  71.      Tree 
  72.      Main Menu 
  73.      Main Toolbar 
  74.      Restoring 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 4.1. The Tree ΓòÉΓòÉΓòÉ
  78.  
  79. TarFront manages its target files and direcories in a tree. There are three 
  80. types of items in this tree: 
  81.  
  82.  Files and directories 
  83.     These are passed directly to tar; directories always contain themselves, 
  84.     all files contained in them and all subdirectories. These entries can be 
  85.     modified by a check mark, which is the default and means that this item 
  86.     will be included, and a cross, which means that this item will be excluded. 
  87.     To toggle between those, double-click on the item. 
  88.  
  89.     Note:  If you want to exclude some files from others, put the exclude 
  90.     entries after the include entries.. 
  91.  
  92.  Root directories 
  93.     Root directories can (and should) have child directories and/or files. 
  94.     Before processing these, the current directory is set to the root directory 
  95.     and all other files/directories are stripped to relative paths. Example: 
  96.     suppose you want to backup a directory inside another temporary directory. 
  97.     Because it would be stupid to have the temporary directory on the tape as 
  98.     well, you can declare the temporary directory as root directory and put the 
  99.     "real" backup directory into it. 
  100.  
  101.     The combination of a root directory "e:\temp" and a directory 
  102.     "e:\temp\back"  inside it would lead to the tar command "tar [options] -C 
  103.     e:\temp back", which means that tar changes to the directory/drive 
  104.     "e:\temp" and backups the file or directory "back". 
  105.  
  106.  Volumes 
  107.     Volume entries start a new tape volume. Each volume is processed as a 
  108.     single tar process and contains all entries that lie "inside" the volume. 
  109.     The default volume name, when none is given, is an (almost) unique number. 
  110.  
  111.  Specifying the to-be-backed-up files and directories is simple - just drag 
  112.  them out of any WPS folder into the main window. You may also add them via the 
  113.  menu, but then you have to enter their names. 
  114.  
  115.  To change entries, hold the Alt key and left-click on them (like you're used 
  116.  to from the WPS). Be aware, though, that TarFront does not check any item for 
  117.  validity - if you enter any wrong values, you have to live with the result. 
  118.  
  119.  To remove entries, drag them onto your Shredder WPS object. 
  120.  
  121.  To associate directories/files with root directories, drag them onto the 
  122.  latter. The same is true for volumes - drag all things that make up a volume 
  123.  into it. 
  124.  
  125.  Defaults 
  126.  
  127.  Volume and root entries are not mandatory. There may be only one single entry 
  128.  (a file or directory), which will be backed up with absolute path into a 
  129.  unnamed volume. On the other hand it is more convenient to have volume entries 
  130.  every time and there could a lot of volumes and root directories in one single 
  131.  tree. 
  132.  
  133.  "Rooted" entries can arbitrarily be mixed with "non-rooted" ones. 
  134.  
  135.  See also: 
  136.  
  137.      Main Menu 
  138.      Main Toolbar 
  139.      Restoring 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 4.2. The Menu ΓòÉΓòÉΓòÉ
  143.  
  144. The TarFront menu contains the following items: 
  145.  
  146.  Options 
  147.     The following options are available: 
  148.  
  149.     Tar settings 
  150.             You can adjust all settings for "tar" that have an effect on 
  151.             backups. For more information, refer to the tar documentation, "tar 
  152.             --help" or this chapter. 
  153.  
  154.     Font 
  155.             The font which is used for trees, containers and the status display 
  156.             can be set with this option. 
  157.  
  158.     Exit 
  159.             Exits the program. 
  160.  
  161.  Items 
  162.     Every type of tree entry can be added here. To change the names to 
  163.     meaningful values (i.e., paths/files), hold the Alt key and left-click on 
  164.     the name. Be sure to use only absolute path names; TarFront does not 
  165.     validate anything, so take special care that your files or directories are 
  166.     spelled correctly (there will be no damage resulting from wrong values, but 
  167.     not everything you wanted to backup will be processed). You may also delete 
  168.     the selected item through this menu, although you can always drag items 
  169.     onto the WPS Shredder object. 
  170.  
  171.  Tape 
  172.     This menu contains all "tape" commands that need no further user 
  173.     interaction. All commands that may damage things are disabled by default; 
  174.     click on "Enable all" to enable them. This setting is not saved in the INI 
  175.     file for savety. For more information on "tape", refer to GTAK.INF, shipped 
  176.     with GTAK. 
  177.  
  178.  Help 
  179.     This menu permits access to the online help facility. 
  180.  
  181.  See also: 
  182.  
  183.      Tree 
  184.      Main Toolbar 
  185.      Restoring 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 4.3. The Main Toolbar ΓòÉΓòÉΓòÉ
  189.  
  190. The main toolbar menu contains the following items: 
  191.  
  192.     With this button you can start the backup process. Everything in the tree 
  193.     will be backed up; a separate tar process is started for every volume (one 
  194.     after the other). Be careful not to terminate TarFront when a backup is 
  195.     still in progress - the tar process will not be killed, and you may get 
  196.     very strange results. 
  197.  
  198.     TarFront will open a tree-like display containing all files available for 
  199.     restoring. 
  200.  
  201.  See also: 
  202.  
  203.      Tree 
  204.      Main Menu 
  205.      Restoring 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 4.4. Restoring ΓòÉ